Skip to main content
Feedback

Reject Quarantined Entity by Source Entity ID

The Reject Quarantined Entity by Source Entity ID operation resolves a quarantine entry for a potential duplicate error or record already end-dated error by rejecting the quarantined entity. A REJECT update is sent to the source so the source and Hub are in sync. This operation is associated with a specified quarantined entity from a given universe (deployed model) for the authenticated user.

Basic authentication

To perform this operation using Basic auth, send an HTTP POST request with an empty request body to:

https://<base URL>/mdm/universes/<universeID>/quarantine/sources/<sourceID>/entities/<entityID>/reject

where base URL is the URL for your Hub cloud that hosts your repository.

Also, where <universeID> is the ID of the universe, sourceID is the source ID, and <entityID> is the entity ID.

JWT authentication

To perform this operation using JSON Web Token (JWT) auth, send an HTTP POST request with an empty request body to:

https://<base URL>/mdm/universes/<universeID>/quarantine/sources/<sourceID>/entities/<entityID>/reject?repositoryId=<repository ID>

You must have the following MDM privileges:

  • With the Advanced Security feature on your account:

    • MDM - Stewardship with the Reject Quarantine Hub role entitlement for the queried repository
      or
    • MDM - Stewardship Management

  • Without Advanced Security:

    • MDM - Stewardship

Path parameters

universeID
ID of the universe

sourceID
ID of the source

entityID
ID of the source entity. It must be URL encoded if it contains special characters.

Query parameters

repositoryId
ID of the repository. Case sensitive. Required with JWT authentication only. You can obtain the repository ID from the URL after navigating to the repository in the user interface.

Responses

  • 200 (OK) Deleted the retrieved quarantine entry and an update request specifying a delete operation propagated on the channel of the contributing source.

  • 400 (Bad Request) The cause for quarantining of the entity was neither a potential duplicate error nor a record already end-dated error. Sample response body:

    <error>
       <message>This quarantine transaction is not rejectable.</message>
    </error>

  • 400 (Bad Request) The universeID parameter value contains only space characters. Sample response body:

    <error>
       <message>The given universe id is blank.</message>
    </error>

  • 404 (Not Found) universeID does not identify a universe under the authenticated account. Sample response body:

    <error>
       <message>A universe with id 'ac11cc59-c77a-4afe-8c92-ed86a7daabec' does not exist.</message>
       <message>Universe definition with id 'ac11cc59-c77a-4afe-8c92-ed86a7daabec' could not be loaded from plugin component directory 'plugins/mdm/bundles/ac11cc59-c77a-4afe-8c92-ed86a7daabec'.</message>
    </error>

  • 404 (Not Found) sourceID does not identify a source attached to the specified universe. Sample response body:

    <error>
       <message>Source with code 'FOO' does not exist under universe '851a6a64-6a88-4916-a5b7-d6a974d54318'.</message>
    </error>

  • 404 (Not Found) entityID does not identify a quarantine entry for the specified source. Sample response body:

    <error>
       <message>The entity '1' from source 'NS' for universe 'ac11cc59-c77a-4afe-8c92-ed86a7daabec' is not quarantined.</message>
    </error>

  • 401 (Invalid Credentials) JWT auth token is expired. Sample response body:

    <body>
    <h2>HTTP ERROR 401</h2>
       <p>Problem accessing /mdm/universes. Reason:
       <pre>Invalid credentials.</pre>
    </p>
    </body>

  • 403 (You do not have permissions to access this resource) User does not have the required MDM privilege to perform the action. Applicable to JWT auth only. Sample response body:

    <error><message>You do not have permissions to access this resource.</message></error>
On this Page